home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XrmPutResource.z / XrmPutResource
Encoding:
C/C++ Source or Header  |  2002-10-03  |  7.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XrmPutResource, XrmQPutResource, XrmPutStringResource,
  10.           XrmQPutStringResource, XrmPutLineResource - store database
  11.           resources
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           void XrmPutResource(_d_a_t_a_b_a_s_e, _s_p_e_c_i_f_i_e_r, _t_y_p_e, _v_a_l_u_e)
  15.                XrmDatabase *_d_a_t_a_b_a_s_e;
  16.                char *_s_p_e_c_i_f_i_e_r;
  17.                char *_t_y_p_e;
  18.                XrmValue *_v_a_l_u_e;
  19.  
  20.           void XrmQPutResource(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s, _t_y_p_e,
  21.           _v_a_l_u_e)
  22.                XrmDatabase *_d_a_t_a_b_a_s_e;
  23.                XrmBindingList _b_i_n_d_i_n_g_s;
  24.                XrmQuarkList _q_u_a_r_k_s;
  25.                XrmRepresentation _t_y_p_e;
  26.                XrmValue *_v_a_l_u_e;
  27.  
  28.           void XrmPutStringResource(_d_a_t_a_b_a_s_e, _s_p_e_c_i_f_i_e_r, _v_a_l_u_e)
  29.                XrmDatabase *_d_a_t_a_b_a_s_e;
  30.                char *_s_p_e_c_i_f_i_e_r;
  31.                char *_v_a_l_u_e;
  32.  
  33.           void XrmQPutStringResource(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s,
  34.           _v_a_l_u_e)
  35.                XrmDatabase *_d_a_t_a_b_a_s_e;
  36.                XrmBindingList _b_i_n_d_i_n_g_s;
  37.                XrmQuarkList _q_u_a_r_k_s;
  38.                char *_v_a_l_u_e;
  39.  
  40.           void XrmPutLineResource(_d_a_t_a_b_a_s_e, _l_i_n_e)
  41.                XrmDatabase *_d_a_t_a_b_a_s_e;
  42.                char *_l_i_n_e;
  43.  
  44.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  45.           _b_i_n_d_i_n_g_s  Specifies a list of bindings.
  46.  
  47.           _d_a_t_a_b_a_s_e  Specifies the resource database.
  48.  
  49.           _l_i_n_e      Specifies the resource name and value pair as a
  50.                     single string.
  51.  
  52.           _q_u_a_r_k_s    Specifies the complete or partial name or the
  53.                     class list of the resource.
  54.  
  55.           _s_p_e_c_i_f_i_e_r Specifies a complete or partial specification of
  56.                     the resource.
  57.  
  58.           _t_y_p_e      Specifies the type of the resource.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _v_a_l_u_e     Specifies the value of the resource, which is
  75.                     specified as a string.
  76.  
  77.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  78.           If database contains NULL, _X_r_m_P_u_t_R_e_s_o_u_r_c_e creates a new
  79.           database and returns a pointer to it.  _X_r_m_P_u_t_R_e_s_o_u_r_c_e is a
  80.           convenience function that calls _X_r_m_S_t_r_i_n_g_T_o_B_i_n_d_i_n_g_Q_u_a_r_k_L_i_s_t
  81.           followed by:
  82.  
  83.           XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)
  84.      If the specifier and type are not in the Host Portable Character
  85.      Encoding, the result is implementation-dependent.  The value is
  86.      stored in the database without modification.
  87.  
  88.           If database contains NULL, _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e creates a new
  89.           database and returns a pointer to it.  If a resource entry
  90.           with the identical bindings and quarks already exists in the
  91.           database, the previous type and value are replaced by the
  92.           new specified type and value.  The value is stored in the
  93.           database without modification.
  94.  
  95.           If database contains NULL, _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e creates a
  96.           new database and returns a pointer to it.
  97.           _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e adds a resource with the specified
  98.           value to the specified database.  _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e is a
  99.           convenience function that first calls
  100.           _X_r_m_S_t_r_i_n_g_T_o_B_i_n_d_i_n_g_Q_u_a_r_k_L_i_s_t on the specifier and then calls
  101.           _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, using a ``String'' representation type.  If
  102.           the specifier is not in the Host Portable Character
  103.           Encoding, the result is implementation-dependent.  The value
  104.           is stored in the database without modification.
  105.  
  106.           If database contains NULL, _X_r_m_Q_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e creates a
  107.           new database and returns a pointer to it.
  108.           _X_r_m_Q_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e is a convenience routine that
  109.           constructs an _X_r_m_V_a_l_u_e for the value string (by calling
  110.           _s_t_r_l_e_n to compute the size) and then calls _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e,
  111.           using a ``String'' representation type.  The value is stored
  112.           in the database without modification.
  113.  
  114.           If database contains NULL, _X_r_m_P_u_t_L_i_n_e_R_e_s_o_u_r_c_e creates a new
  115.           database and returns a pointer to it.  _X_r_m_P_u_t_L_i_n_e_R_e_s_o_u_r_c_e
  116.           adds a single resource entry to the specified database.  The
  117.           line should be in valid ResourceLine format (see section
  118.           15.1) terminated by a newline or null character; the
  119.           database that results from using a string with incorrect
  120.           syntax is implementation-dependent.  The string is parsed in
  121.           the locale of the database.  If the _R_e_s_o_u_r_c_e_N_a_m_e is not in
  122.           the Host Portable Character Encoding, the result is
  123.           implementation-dependent.  Note that comment lines are not
  124.           stored.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXrrrrmmmmPPPPuuuuttttRRRReeeessssoooouuuurrrrcccceeee((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.           XrmGetResource(3X11), XrmInitialize(3X11),
  142.           XrmMergeDatabases(3X11), XrmUniqueQuark(3X11)
  143.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.